Inside Macintosh: QuickTime Components /

Chapter 9 - Movie Data Exchange Components / Movie Data Exchange Components Reference

Configuring Movie Data Import Components /

MovieImportSetDimensions

The MovieImportSetDimensions function allows an application to specify a new track's spatial dimensions.

pascal ComponentResult MovieImportSetDimensions
                               (ComponentInstance ci, Fixed width, 
                                 Fixed height);

ci

Identifies the application's connection to your movie data import component.

width

Indicates the width, in pixels, of the track rectangle. This parameter, along with the height parameter, specifies a rectangle that surrounds the image that is to be displayed when the current media is played. This value corresponds to the x coordinate of the lower-right corner of the rectangle, and it is expressed as a fixed-point number.

height

Indicates the height, in pixels, of the track rectangle. This value corresponds to the y coordinate of the lower-right corner of the rectangle, and it is expressed as a fixed-point number.

DESCRIPTION

Applications may use this function to specify the spatial dimensions of a new track. Although your movie data import component may not change the spatial characteristics of an existing track, if you are importing image data into a new track, you may choose to allow applications to specify the spatial characteristics of the new track.

If you want to change the track's matrix, use the Movie Toolbox's SetTrackMatrix function after performing the import operation.

RESULT CODE

badComponentSelector

0x80008002

Function not supported

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help